home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / graphics / jpeg4bin.zoo / djpeg.1 < prev    next >
Text File  |  1993-01-17  |  5KB  |  133 lines
  1. DJPEG(1)                 USER COMMANDS                   DJPEG(1)
  2.  
  3.  
  4.  
  5. NAME
  6.      djpeg - decompress a JPEG file to an image file
  7.  
  8. SYNOPSIS
  9.      djpeg [ -colors _✓N ] [ -gif ] [ -pnm ] [ -rle ] [ -targa ]  [
  10.      -blocksmooth ] [ -grayscale ] [ -maxmemory _✓N ] [ -nodither ]
  11.      [ -onepass ] [ -verbose ] [ -debug ] [ _✓f_✓i_✓l_✓e_✓n_✓a_✓m_✓e ]
  12.  
  13. DESCRIPTION
  14.      djpeg decompresses the named  JPEG  file,  or  the  standard
  15.      input if no file is named, and produces an image file on the
  16.      standard output.  PBMPLUS  (PPM/PGM),  GIF,  Targa,  or  RLE
  17.      (Utah  Raster  Toolkit) output format can be selected.  (RLE
  18.      is supported only if the URT library is available.)
  19.  
  20. OPTIONS
  21.      All switch names may be abbreviated; for example, -grayscale
  22.      may  be  written -gray or -gr.  Most of the "basic" switches
  23.      can be abbreviated to as little as one  letter.   Upper  and
  24.      lower  case  are equivalent (thus -GIF is the same as -gif).
  25.      British spellings  are  also  accepted  (e.g.,  -greyscale),
  26.      though for brevity these are not mentioned below.
  27.  
  28.      The basic switches are:
  29.  
  30.      -colors _✓N
  31.           Reduce image to at most N  colors.   This  reduces  the
  32.           number  of  colors used in the output image, so that it
  33.           can be displayed on a colormapped display or stored  in
  34.           a colormapped file format.  For example, if you have an
  35.           8-bit display, you'd need to reduce  to  256  or  fewer
  36.           colors.
  37.  
  38.      -quantize _✓N
  39.           Same as -colors.   -colors  is  the  recommended  name,
  40.           -quantize is provided only for backwards compatibility.
  41.  
  42.      -gif Select GIF output format.  Since GIF does  not  support
  43.           more  than  256  colors, -colors 256 is assumed (unless
  44.           you specify a smaller number of colors).
  45.  
  46.      -pnm Select PBMPLUS (PPM/PGM) output  format  (this  is  the
  47.           default  format).   PGM  is emitted if the JPEG file is
  48.           gray-scale or if -grayscale is specified; otherwise PPM
  49.           is emitted.
  50.  
  51.      -rle Select RLE output format.  (Requires URT library.)
  52.  
  53.      -targa
  54.           Select Targa output format.  Gray-scale format is emit-
  55.           ted  if the JPEG file is gray-scale or if -grayscale is
  56.           specified; otherwise, colormapped format is emitted  if
  57.           -colors is specified; otherwise, 24-bit full-color for-
  58.           mat is emitted.
  59.  
  60.      Switches for advanced users:
  61.  
  62.      -blocksmooth
  63.           Perform cross-block smoothing.  This is  quite  memory-
  64.           intensive  and  only seems to improve the image at very
  65.           low quality settings (-quality 10 to  20  or  so).   At
  66.           normal quality settings it may make the image worse.
  67.  
  68.      -grayscale
  69.           Force gray-scale output even if  JPEG  file  is  color.
  70.           Useful for viewing on monochrome displays.
  71.  
  72.      -maxmemory _✓N
  73.           Set limit for amount of memory  to  use  in  processing
  74.           large  images.  Value is in thousands of bytes, or mil-
  75.           lions of bytes if "M" is attached to the  number.   For
  76.           example,  -max 4m selects 4000000 bytes.  If more space
  77.           is needed, temporary files will be used.
  78.  
  79.      -nodither
  80.           Do  not  use  dithering  in  color  quantization.    By
  81.           default,  Floyd-Steinberg  dithering  is  applied  when
  82.           quantizing colors, but on  some  images  dithering  may
  83.           result in objectionable "graininess".  If that happens,
  84.           you can turn off dithering with  -nodither.   -nodither
  85.           is ignored unless you also say -colors _✓N.
  86.  
  87.      -onepass
  88.           Use one-pass instead of  two-pass  color  quantization.
  89.           The  one-pass  method  is faster and needs less memory,
  90.           but it produces a  lower-quality  image.   -onepass  is
  91.           ignored  unless you also say -colors _✓N.  Also, the one-
  92.           pass method is always used for gray-scale  output  (the
  93.           two-pass method is no improvement then).
  94.  
  95.      -verbose
  96.           Enable debug printout.  More  -v's  give  more  output.
  97.           Also, version information is printed at startup.
  98.  
  99.      -debug
  100.           Same as -verbose.
  101.  
  102. EXAMPLES
  103.      This example decompresses the JPEG file  foo.jpg,  automati-
  104.      cally  quantizes  to 256 colors, and saves the output in GIF
  105.      format in foo.gif:
  106.  
  107.           djpeg -gif _✓f_✓o_✓o._✓j_✓p_✓g > _✓f_✓o_✓o._✓g_✓i_✓f
  108.  
  109. ENVIRONMENT
  110.      JPEGMEM
  111.           If this environment variable is set, its value  is  the
  112.           default  memory  limit.   The  value  is  specified  as
  113.           described for the -maxmemory switch.  JPEGMEM overrides
  114.           the  default  value specified when the program was com-
  115.           piled, and itself is overridden by  an  explicit  -max-
  116.           memory.
  117.  
  118. SEE ALSO
  119.      cjpeg(1)
  120.      ppm(5), pgm(5)
  121.      Wallace, Gregory K.  "The  JPEG  Still  Picture  Compression
  122.      Standard",  Communications  of the ACM, April 1991 (vol. 34,
  123.      no. 4), pp. 30-44.
  124.  
  125. AUTHOR
  126.      Independent JPEG Group
  127.  
  128. BUGS
  129.      Arithmetic coding is not supported for legal reasons.
  130.  
  131.      Still not as fast as we'd like.
  132.  
  133.